home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 2 / Meeting Pearls Vol. II (1995)(GTI - Schatztruhe)[!].iso / Pearls / dev / GUI / EAGUI / ReadMe.doc < prev    next >
Text File  |  1994-02-16  |  9KB  |  191 lines
  1.  
  2. -----------------------------------------------------------------------------
  3.  
  4.                  Environment Adaptive Graphic User Interface
  5.  
  6. -----------------------------------------------------------------------------
  7. $RCSfile: ReadMe.doc,v $
  8. $Revision: 2.3 $
  9. $Date: 1994/02/17 02:44:54 $
  10. -----------------------------------------------------------------------------
  11.  
  12.      Copyright
  13.      ¯¯¯¯¯¯¯¯¯
  14. EAGUI is Copyright © 1993, 1994 by Marcel Offermans and Frank Groen, and may
  15. not be disassembled or reverse-engineered in any way. You may use this
  16. software at your own risk. We cannot be held responsible for any damage it
  17. might do. You may copy the original archive, but you're not allowed to rename
  18. it or change its contents (to avoid confusion). Also, you may not charge
  19. anything for it, other than the costs of the media it is on.
  20.  
  21.  
  22.      Requirements
  23.      ¯¯¯¯¯¯¯¯¯¯¯¯
  24. EAGUI needs at least Release 2, because it makes use of a lot of its
  25. features. It is Release 3 aware.
  26.  
  27.  
  28.      Archive Contents and Installation
  29.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  30. The archive should contain the following files. We've carefully chosen them,
  31. so that the archive doesn't grow needlessly big. You should be able to build
  32. everything from these files. Reading these descriptions should be enough to
  33. be able to install the package.
  34.      "EAGUI.library" - Should go in your LIBS: directory, or any other
  35. directory from which it can be loaded.
  36.      "EAGUI.h" - Header file that you need to include in your sources. If you
  37. use any other language than C, you need to rewrite this file.
  38.      "EAGUI_macros.h" - Header file containing macros, which make life
  39. easier. These too are written for C, so if you use another language, you
  40. might want to rewrite these too.
  41.      "EAGUI_protos.h" - Prototypes for the library functions. They're
  42. included by "EAGUI.h", so you don't need to include this file yourself.
  43.      "EAGUI_lib.c" - Stubs for varargs function calls. You must compile these
  44. and link them to your source. The file is tested with the SAS/C compiler, but
  45. may need some modification with others. If you use the SAS/C compiler, you
  46. can also make use of its `#pragma tagcall' option instead.
  47.      "EAGUI.fd" - Standard FD file, which can be used to generate pragmas for
  48. SAS/C. Lots of other languages need such a file too.
  49.      "EAGUI.doc" - Standard autodoc file, containing all public functions in
  50. the library. You can use this file to create an AmigaGuide version, if you
  51. like that better.
  52.      "ReadMe.doc" - This file, containing the Copyright notice, the Archive
  53. Contents and other information.
  54.      "Tutorial.doc" - A tutorial, which explains how to use the library in
  55. your own applications.
  56.      "Tutorial_1.pic" - A picture of some important layout parameters of
  57. objects, as explained in the tutorial.
  58.      "example.c" - A simple example source. This is the example that is
  59. mentioned in the tutorial.
  60.      "example" - The executable of the example, for those of you who want to
  61. see EAGUI in action right away. The executable takes two optional command
  62. line parameters: a fontname (including the .font suffix) and a font y-size.
  63.  
  64.  
  65.      Using EAGUI
  66.      ¯¯¯¯¯¯¯¯¯¯¯
  67. If you're an application programmer, and you want to use EAGUI, please keep
  68. the following in mind. Depending on the type of software you write, the
  69. conditions under which you may use EAGUI differ. Basically, if you don't make
  70. any money out of your program, we don't expect you to pay us in any way.
  71.      If you use it in any Public Domain or FreeWare software, you may use
  72. EAGUI for free. The only thing we want you to do, is keep us informed of the
  73. fact that you've used EAGUI.
  74.      If you use it in any ShareWare software, you must first contact us, to
  75. obtain some kind of licence. Usually we'll settle for a free registration, or
  76. something like that.
  77.      If you use it in any Commercial software, you must first contact us. We
  78. will then work out a deal.
  79.  
  80. If you're a application user, you may always use EAGUI for free. This may
  81. sound natural, but some other programmers charge every user for using their
  82. library.
  83.  
  84.  
  85.      Support for Developers
  86.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  87. We support everybody that uses EAGUI as well as we can. We'll be happy to
  88. answer any questions you might have. Currently, we're considering adding some
  89. development tools to the system, but a lot will depend on the feedback we
  90. get. After all, if nobody uses EAGUI, there's no point in supporting it.
  91.  
  92. At the moment, we've only used EAGUI to develop applications in C, but there
  93. is no reason why it shouldn't work with any other language. If you use it in
  94. any other language, and you've written header files for that language, we'd
  95. like you to send them to us, so we can distribute them to other developers.
  96.  
  97.  
  98.      The Future
  99.      ¯¯¯¯¯¯¯¯¯¯
  100. Like most developers, we hope that these kinds of tools will some day be
  101. integrated into the operating system. When designing EAGUI, we've tried to
  102. anticipate what Commodore will do in future releases of the AmigaOS. As soon
  103. as Commodore releases a similar system, we encourage you to use that instead,
  104. and will try to make a release of EAGUI that simple interfaces to this
  105. system.
  106.  
  107.  
  108.      The Authors
  109.      ¯¯¯¯¯¯¯¯¯¯¯
  110. We've tried to provide clear, readable documentation. Although it is not our
  111. native language, we've chosen to write everything in english, because that
  112. seems to be the de facto standard for most development documentation. If you
  113. find parts of these documents difficult to understand, or if you discover any
  114. type of mistakes, please report them to us. Also, we're always willing to
  115. answer any questions you might have. If you've found a bug, please state as
  116. clearly as possible how we can reproduce it, or under what circumstances the
  117. bug surfaced, and what your system looks like (computer model, Kickstart
  118. version, Workbench version, any programs running in the background). The more
  119. detailed your bug report is, the better the chance we can fix it quickly.
  120. We're also always looking for ways to enhance the system, so if you have any
  121. suggestions, please mail them to us. Finally, if you don't like EAGUI, please
  122. tell us what you think is wrong with it: we always listen to constructive
  123. criticism.
  124.  
  125. To contact us, write to:
  126.  
  127.      Marcel Offermans
  128.           2:281/614.1@fidonet
  129.           marcel@dutw30.tudelft.nl
  130.  
  131.      Frank Groen
  132.           2:281/614.2@fidonet
  133.           fgroen@tudw12.tudelft.nl
  134.  
  135. We understand the following languages:
  136.  
  137.      nederlands
  138.      english
  139.      deutsch
  140.  
  141. If possible, contact us through fidonet, because then you'll an answer more
  142. quickly.
  143.  
  144.      Development Environment
  145.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  146. EAGUI is developed and tested under Release 3 only, simply because we don't
  147. have any Amiga that uses Release 2 anymore. This does not mean that you need
  148. Release 3 however. It does mean that there just might be bugs that surface
  149. only under Release 2.
  150.  
  151.  
  152.      Thanks to
  153.      ¯¯¯¯¯¯¯¯¯
  154. Commodore-Amiga Inc. for producing this excellent mix of hard- and software
  155. which we've learned to appreciate so much over the years.
  156.  
  157. Everybody that contributes to The Amiga Developers Domain, which is the best
  158. BBS we know.
  159.  
  160. Guns N' Roses, Pearl Jam, Rage Against The Machine, Aerosmith, The Cult.
  161.  
  162. The following persons for bug reports, suggestions and moral support:
  163.      Paul van der Valk, Arnout Grootveld, Roy van der Woning
  164.  
  165.  
  166.      Releases
  167.      ¯¯¯¯¯¯¯¯
  168. Releases are always made available on TADD, from where the archive can be
  169. freq'ed. You can use the magic filename EAGUI, which will always get you the
  170. latest release. TADD (2:281/614) can be reached at +31-15-157954 or
  171. +31-15-144825. Releases will also appear on AmiNet sites (in the dev/gui
  172. directory) from where they can be ftp'ed. They will also be announced on
  173. comp.sys.amiga.announce when they appear on AmiNet.
  174.  
  175. 1.0 - First release.
  176.  
  177. 1.1 - Corrected a lot of small mistakes in the documentation and sources, and
  178. added a full example source (and executable), together with an IFF picture
  179. file, which explains the relation between object border dimensions, offsets
  180. and sizes. Also fixed a bug in ea_LayoutObjects(): Under certain
  181. circumstances, object sizes weren't calculated correctly, and another bug
  182. which caused a lot of Enforcer BYTE read hits. Furthermore, the
  183. "EAGUI_protos.h" file was added. You need it to compile.
  184.  
  185. 2.0 - There were a few spelling errors in the documentation. They're
  186. corrected now. Furthermore, the rendering method is now fully supported,
  187. which allows you to design and use custom imagery (such as labels).
  188.  
  189. 2.1 - Bugfix. The GadTools button minsize method was broken. This release 
  190. fixes that.
  191.